﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>FarListItem</title>
<meta http-equiv="Content-Type" Content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="../../styles/styles.css">
<script language="javascript" src='../links.js' type="text/javascript"></script>
</head>
<body>

<h1>FarListItem</h1>
<div class=navbar>
<a href="../index.html">главная</a> |
<a href="index.html">структуры</a> |
<a href="../dialogapi/index.html">Dialog API</a>
</div>

<div class=shortdescr>
Структура <code>FarListItem</code> описывает один элемент списка <a href="../dialogapi/controls/di_listbox.html">DI_LISTBOX</a> или <a href="../dialogapi/controls/di_combobox.html">DI_COMBOBOX</a>.
</div>

<pre class=syntax>
struct FarListItem
{
  LISTITEMFLAGS Flags;
  const wchar_t *Text;
  intptr_t UserData;
  intptr_t Reserved;
};
</pre>

<h3>Элементы</h3>
<div class=descr>
  <div class=dfn>Flags</div>
    <div class=dfndescr>Комбинация следующих значений (тип <a name="LISTITEMFLAGS">LISTITEMFLAGS</a>):
    <table class="cont">
    <tr class="cont"><th class="cont" width="40%">Флаг</th><th class="cont" width="60%">Описание</th></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_SELECTED">LIF_SELECTED</a></td>
    <td class="cont" width="60%">Флаг активности пункта списка. Только один пункт может быть активным.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_CHECKED">LIF_CHECKED</a></td>
    <td class="cont" width="60%">Если флаг установлен, то перед текстом пункта отображается символ пометки (например, символ с кодом 0xFB - <code>&#8730;</code>).</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_SEPARATOR">LIF_SEPARATOR</a></td>
    <td class="cont" width="60%">Если флаг установлен, то пункт отображается как разделитель. Разделитель может иметь непустой текст, который будет отображаться поверх разделительной линии.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_DISABLE">LIF_DISABLE</a></td>
    <td class="cont" width="60%">Если флаг установлен, то пункт недоступен.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_GRAYED">LIF_GRAYED</a></td>
    <td class="cont" width="60%">Если флаг установлен, то пункт доступен в навигации, но не доступен для выбора.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_HIDDEN">LIF_HIDDEN</a></td>
    <td class="cont" width="60%">Если флаг установлен, то пункт не выводится на экран.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_DELETEUSERDATA">LIF_DELETEUSERDATA</a></td>
    <td class="cont" width="60%">Этот флаг устанавливается в параметре Item сообщения <a href="../dialogapi/dmsg/dm_listupdate.html">DM_LISTUPDATE</a>, если при обновлении элемента списка необходимо удалить связанные с этим элементом данные.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="LIF_NONE">LIF_NONE</a></td>
    <td class="cont" width="60%">Нулевой флаг.</td></tr>
    </table>
    </div>
  <div class=dfn>Text</div>
    <div class=dfndescr>Текст элемента списка.</div>
  <div class=dfn>UserData</div>
    <div class=dfndescr>Пользовательские данные. Для хранения в элементе списка более чем <code>sizeof(intptr_t)</code> байт используйте <a href="farlistitemdata.html">FarListItemData</a>.</div>
  <div class=dfn>Reserved</div>
    <div class=dfndescr>Зарезервировано, должно быть равно <code>0</code>.</div>
</div>

<h3>Замечания</h3>
<div class=descr>
<ol>
<li>В младшем слове <code>Flags</code> можно указывать код символа, который будет использоваться для отображения метки выбора. В этом случае система самостоятельно выставит флаг <code>LIF_CHECKED</code> для данного пункта меню.</li>
<li>Если младшее слово <code>Flags</code> равно <code>0</code> и выставлен флаг <code>LIF_CHECKED</code>, или если младшее слово <code>Flags</code> равно <code>1</code>, то будет отображаться стандартная метка выбора - символ с кодом 0FBh (<code>&#8730;</code>)</li>
<li>При использовании флага <code>LIF_SEPARATOR</code> без текста, компонента <code>Text</code> должна быть проинициализирована в <code>0</code>, например так:
<pre class=code>
struct FarListItem Item;
Item.Flags=LIF_SEPARATOR;
Item.Text=NULL;</pre></li>
</ol>
</div>

<div class=see>Смотрите также:</div>
<div class=seecont>
<a href="farlist.html">FarList</a>,
<a href="../dialogapi/dmsg/dm_listgetitem.html">DM_LISTGETITEM</a>,
<a href="farlistinsert.html">FarListInsert</a>,
<a href="farlistupdate.html">FarListUpdate</a>
</div>

</body>
</html>